Manage orders - Gets a list of product promotions.
Ruft die verfügbaren Werbeaktionen des Partners ab.
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions?country={country}&segment={segment}
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
version
|
path | True |
string |
|
|
country
|
query |
string |
Das Land. |
|
|
segment
|
query |
string |
Das Segment. |
Anforderungsheader
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| Authorization | True |
string |
Autorisierungs-Bearertoken |
| ms-correlationid |
string |
Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue. |
|
| MS-CV |
string |
Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn kein MS-CV bereitgestellt wird, generiert der Server für jede Anforderung eine neue. |
|
| ms-requestid |
string |
Wird für die Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue anforderung. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Die Anforderung war erfolgreich. Der Antworttext enthält eine Liste der Werbeaktionen für den Partner. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 400 Bad Request |
Es fehlte eine oder eine ungültige Eingabe. Der Antworttext enthält die Fehlerdetails. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 401 Unauthorized |
Die Anforderung wurde nicht authentifiziert. Der Client muss sich zuerst beim Partner-API-Dienst authentifizieren. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 403 Forbidden |
Die Anforderung wurde authentifiziert, wurde aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
Die Ressource wurde mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 500 Internal Server Error |
Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Definitionen
Contracts.V1.Models.ProductPromotion
| Name | Typ | Beschreibung |
|---|---|---|
| description |
string |
|
| endDate |
string (date-time) |
|
| id |
string |
|
| name |
string |
|
| properties | ||
| requiredProducts | ||
| startDate |
string (date-time) |
Contracts.V1.Models.ProductPromotionPricingPolicy
| Name | Typ | Beschreibung |
|---|---|---|
| policyType |
string |
|
| value |
string |
Contracts.V1.Models.ProductPromotionProperties
| Name | Typ | Beschreibung |
|---|---|---|
| isAutoApplicable |
boolean |
Contracts.V1.Models.ProductPromotionRequiredProduct
| Name | Typ | Beschreibung |
|---|---|---|
| pricingPolicies | ||
| productId |
string |
|
| skuId |
string |
|
| term |
Contracts.V1.Models.ProductPromotionTerm
| Name | Typ | Beschreibung |
|---|---|---|
| billingCycle |
string |
|
| duration |
string |
Link
| Name | Typ | Beschreibung |
|---|---|---|
| body |
string |
|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
ResourceAttributes
| Name | Typ | Beschreibung |
|---|---|---|
| etag |
string |
|
| objectType |
string |
ResourceCollection[Contracts.V1.Models.ProductPromotion]
| Name | Typ | Beschreibung |
|---|---|---|
| attributes | ||
| items | ||
| links | ||
| totalCount |
integer (int32) |
ResourceLinks
| Name | Typ | Beschreibung |
|---|---|---|
| next | ||
| previous | ||
| self |
System.Collections.Generic.KeyValuePair[System.String,System.String]
| Name | Typ | Beschreibung |
|---|---|---|
| key |
string |
|
| value |
string |